home *** CD-ROM | disk | FTP | other *** search
/ The World's Largest Collection of Windows Software / The World's Largest Collection of Windows Software - Disc 1.iso / ed_int / iq11 / readme.txt < prev   
Text File  |  1993-08-15  |  11KB  |  252 lines
  1. Introduction
  2. ------------
  3.  
  4. Import Quotes (IQ) is a Windows program that convert and import quotes into
  5. Quicken.  Quotes retrieved from online services such as CompuServe and 
  6. Fidelity Online Exchange can be converted to a Quicken import file, and
  7. imported directly into Quicken.
  8.  
  9. To convert quotes, you simply create a file containing the quotes. Next you
  10. tell IQ where the file is, and how to parse it.  Finally,  you start the
  11. conversion, and IQ  creates an import file with the converted quotes.
  12. The method for saving quotes from online services will vary.  If you use
  13. WINCIM, you save quotes after they are displayed by selecting "save as" from
  14. the file menu, and entering a filename  (Tip: setup the recorder with a 
  15. hot-key to automate saving quotes to a file).
  16.  
  17. The IQ program import quotes into Quicken by mimicing Quicken keystrokes to
  18. import quotes from a file.  When an import is started, IQ scans the desktop
  19. for Quicken. If Quicken is found, it is activated and sent keystrokes to
  20. import the quotes.  IQ can also be configured to start Quicken if is not 
  21. on the desktop.  However, this is not recommended if you use password 
  22. protection on your Quicken account.  If you do use a password, start 
  23. Quicken, enter your password, and then tell IQ to convert and import the
  24. quotes.  Refer to your Quicken manual for the format of the import quote
  25. file.
  26.  
  27. It is highly recommended that before importing quotes into Quicken, read
  28. the Quicken manual to setup the accounts, along with security symbols.
  29. Also before importing, perform a conversion only and then check the output 
  30. file from the conversion ("filename".iq) to make sure that quotes are being
  31. converted properly.  If you are using an unregistered version, open the 
  32. converted file in an editor such as notepad for viewing.  If you're using a
  33. registered version, turn on logging before the conversion, and then view the
  34. log after the conversion is complete.  If the conversion does not work
  35. properly, adjust the parser parameters and try again.  Once you are
  36. satisfied that the conversion is working properly, start an import.
  37.  
  38.  
  39. Features
  40. --------
  41.  
  42. 1) Convert and/or import quotes into Quicken with one keystroke.
  43. 2) Configurable parser.
  44. 3) Date selection for imported quotes (With this feature, you can enter
  45.    quotes from a previous date).
  46. 3) *Ability to create, store, and retrieve different parser sets.
  47.     (Nice feature if you get quotes from multiple sources and you need
  48.      to keep different parsing parameters for each quote source)
  49. 4) Set Editor for creating parser sets.
  50. 5) *Conversion and import log.
  51.  
  52.  
  53.  
  54.  
  55. File Contents of iq.zip 
  56. -----------------------
  57.  
  58.           readme.txt  - this file
  59.           iq.exe      - import quote executable file
  60.           iqhooks.dll - dynamic link library used by iq
  61.           iq.ini      - initilization file for iq
  62.           bwcc.dll    - borland custom dialog dynamic link library
  63.           order.txt   - registration form
  64.           history.txt - change and bug fix history
  65.  
  66.  
  67. Installation
  68. ------------
  69.  
  70. Create a \iq directory or use the current directory that the files
  71. were unziped into.  The files iq.exe, iqhooks.dll, iq.ini, and order.txt
  72. MUST be in the same directory.  The bwcc.dll file should be moved to the
  73. \windows\system directory if one is not already present, or is older than
  74. this version.  Next, using program manager, create a new item in your
  75. desired program group and enter the file name along with path for IQ
  76. (iq\iq.exe) in the command line entry.
  77.  
  78.  
  79. Program Operation
  80. -----------------
  81.  
  82.  
  83. Main Control Dialog
  84. -------------------
  85.  
  86. Start     - Press the start pushbutton to convert and/or import
  87.             quotes.  Note: setup options after installation before
  88.             entering start.
  89.  
  90. Options   - Press the options pushbutton to open the options dialog box.
  91.  
  92. *View Log - Press the view log pushbutton to view the conversion/import
  93.             log 
  94.  
  95. About     - Press the about pushbutton to get info about the program and to
  96.             register.
  97.  
  98.  
  99.  
  100.  
  101. Options Dialog
  102. --------------
  103.  
  104. 'Program Control' is where you tell IQ what to do when the start button is
  105. pressed.  IQ can be instructed to convert, import, or convert
  106. and import when the start pushbutton is pressed.
  107.  
  108. When the *'log' flag is set, IQ logs all conversions and imports to the log
  109. file.  The log file name is "iq.log", and it is created in the same
  110. directory that the "iq.exe" file resides in.
  111.  
  112. The 'Quote Input File' is the path and filename that contains the
  113. quotes to be converted.  This is the file that is saved from your online
  114. service or other source.  When performing a conversion, IQ creates a
  115. new file with the same name as your input file with a '.iq' extension.
  116. This new file contains the converted quotes and is created in the same
  117. directory that the Quote Input File resides in.  If no path is specified,
  118. the Quote Input File is assumed to be in the current working directory.
  119.  
  120.  
  121. The 'Quicken Command' is the command line to start Quicken.  If you set
  122. this up, IQ will execute this command before importing if Quicken is not
  123. running on the desktop.  You should leave this field blank if you use 
  124. password protection on your Quicken account.
  125.  
  126. The 'Conversion Parser' section contains the parameters that tell IQ
  127. how to parse the 'Quote Input File'.  A quote consist of three components,
  128. a symbol, price, and date.  The parser parameters tell IQ which columns
  129. in the 'Quote Input File' contains these components and what is the
  130. starting row or line of the first quote.
  131.  
  132.    Most quotes that are retrieved contain some number of header lines before 
  133.    the first quote.  Enter a number between 0 and 99 in the 'Header Lines'
  134.    field to indicate the number of header lines before the first quote.
  135.  
  136.    Enter a column number between 1 and 239 for the 'Symbol Column'.
  137.  
  138.    Enter a column number between 1 and 239 for the 'Price Column'.
  139.  
  140.    Enter the source of the date from the list.  The date can be taken from
  141.    either the 'Quote Input File', from the field below, or the current date.
  142.    If the current date is selected, the date will be the date that the
  143.    quotes are converted.  If the date source is from the field, enter the
  144.    date (mm/dd/yy) in the date field.  If the date source is from the file,
  145.    enter a column number between 1 and 239 for the 'Date Column'.
  146.  
  147.  
  148. The Create, Load, and Delete pushbuttons are used to create/save, load
  149. and delete parser sets.  One parser set consist of:
  150.  
  151.              o User supplied tag (up to 8 chars.)
  152.              o Number of header lines
  153.              o Symbol Column
  154.              o Price Column
  155.              o Date Column
  156.              o Date Source
  157.  
  158. Create - Press the create pushbutton to start the set editor to create and
  159.          save a parser set.
  160.  
  161. Load   - Press the load pushbutton to load a parser set into the option
  162.          menu conversion parser fields.
  163.  
  164. Delete - Press the delete pushbutton to delete a parser set.
  165.  
  166. There are two predefined parser sets available with the program:
  167.  
  168.              Number of Header      Symbol     Price     Date     Date
  169.  TAG         Lines                 Column     Column    Column   Source
  170. ---------    ------------------    ------     ------    ------   ------
  171. WINCIM              2                1          36       56      Current
  172. FOX                 2                18         46       145     From File
  173.  
  174.  
  175. If you use WINCIM to get quotes, use the WINCIM parser set to parse a quote
  176. file saved from WINCIM.  If you create an export file from Fidelity Online
  177. Exchange, use the FOX parser set to parse this file.  Use the set editor to
  178. create additional parser sets.
  179.  
  180. OK     - Press the OK pushbutton to save the options and return to the
  181.          main control dialog.  
  182.  
  183. Cancel - Press the cancel pushbutton to discard any changes made while
  184.          in the option menu, and return to the main control dialog.
  185.  
  186.  
  187. Set Editor - Creating a parser set
  188. ----------------------------------
  189.  
  190. Use the set editor to create and save a parser set.  Before starting the
  191. editor, enter the 'Quote Input file'.  This is the file that will be loaded
  192. into the editor.  The set editor initializes with the parser parameters
  193. from the option menu.  Make sure that the marker option is on to see the
  194. current parser settings applied to the file.
  195.  
  196. To create a parser set, position the cursor to the symbol column for the
  197. first quote in the file and press the left-mouse button.  A cursor position
  198. dialog box will appear.  Check the 'first quote row' box and the 'symbol 
  199. column' box.  If the marker option is on, the symbol column should appear in
  200. reverse video starting at the first quote row, and the letter 'S' will be
  201. displayed on the first row.  To identify the price column, position the
  202. cursor to the price column, press the left-mouse button, and check the 
  203. 'price column' box (column reverse video with letter 'P' in the first row).
  204. To identify the date column, position the cursor to the date column, press
  205. the left-mouse button, and check the 'date column' box (column reverse video
  206. with the letter 'D' in first row).  Note, the first quote can be identified
  207. at anytime or while obtaining the symbol, price, or date column.
  208.  
  209.    File Menu
  210.  
  211.        Save - Save the editor parser settings, i.e. the number of header
  212.               lines, symbol column, price column, date column, and date
  213.               source.  Enter a tag to identify the parser set.  Once the
  214.               set has been created it can be loaded into the option menu
  215.               conversion parser fields at anytime by pressing the load
  216.               pushbutton on the option menu.
  217.   
  218.        Quit - Discard the editor parser settings and return to the option
  219.               menu.
  220.  
  221.        Exit - Move the editor parser settings, i.e. the number of header
  222.               lines, symbol column, price column, date column, and date
  223.               source to the option menu conversion parser fields and return
  224.               to the option menu.
  225.  
  226.    Options Menu
  227.  
  228.        Markers - Select Markers to turn the settings markers on or off.
  229.  
  230.        Date    - Select the date source for the quotes.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  Notes on Parsing
  237. -----------------
  238.  
  239.   Right-Adusted data & White Spaces
  240.   ---------------------------------
  241.  
  242.       The parser is capable of skipping over white spaces preceding
  243.       a column entry.  This gives the parser the capability to parse
  244.       right-adjusted data in columns.  When parsing right-adjusted
  245.       data columns, the best place to set the cursor is the column
  246.       immediately following the previous data column, which is usually
  247.       a blank.
  248.       
  249.  
  250.  
  251. * Only available in the licensed version.
  252.